Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 4 - Unicode Converter Reference / Unicode Converter Structures and Other Types

/

UnicodeToTextInfo

Many of the Unicode Converter functions that perform conversions require a Unicode converter object containing information used for the conversion process. There are three types of Unicode converter objects used for different types of conversions. You use the UnicodeToTextInfo type, described here, for converting from Unicode to text.

Because your application cannot directly create or modify the contents of the private Unicode converter object, the Unicode Converter provides functions to create and dispose of it. To create a Unicode converter object for converting from Unicode to text, your application must first call either the function CreateUnicodeToTextInfo (page 135) or CreateUnicodeToTextInfoByEncoding (page 136).

You can then pass this object to the function ConvertFromUnicodeToText (page 139) or ConvertFromUnicodeToPString (page 165) to identify the information used to perform the actual conversion. After you have finished using the object, you should release the memory allocated for it by calling the function DisposeUnicodeToTextInfo (page 143).

A Unicode converter object for this purpose is defined by the UnicodeToTextInfo data type.

typedef struct OpaqueUnicodeToTextInfo *UnicodeToTextInfo;

Another function, TruncateForUnicodeToText (page 162), also requires a Unicode converter object as a parameter. This function does not modify the contents of the private structure to which the Unicode converter object refers, so it uses the constant Unicode converter object defined by the ConstUnicodeToTextInfo data type.

typedef const UnicodeToTextInfo ConstUnicodeToTextInfo;

SEE ALSO

The Unicode converter object of type TextToUnicodeInfo (page 119) that you use for converting from non-Unicode text to Unicode text.

The Unicode converter object of type UnicodeToTextRunInfo (page 121) that you use to convert from Unicode text to runs of text expressed in various encodings.